ИМЯ¶

chown, fchown, lchown - изменить владельца файла

ОБЗОР¶

#include <sys/types.h>
#include <unistd.h>

int chown(const char *path, uid_t owner, gid_t group);
int fchown(int fd, uid_t owner, gid_t group);
int lchown(const char *path, uid_t owner, gid_t group);

ОПИСАНИЕ¶

Изменяет владельца для файла, задаваемого параметрами path или fd. Только суперпользователь может изменять владельца файла. Владелец файла может изменять группу файла на любую группу, к которой он принадлежит. Суперпользователь может произвольно изменять группу.

Если параметр owner или group заданы как -1, то соответствующий идентификатор не изменяется.

Когда владелец или группа исполняемого файла изменяются не-суперпользователем, то очищаются биты S_ISUID и S_ISGID. POSIX не требует, чтобы это происходило, когда суперпользователь выполняет chown; в этом случае поведение зависит от версии ядра Linux. Если в правах доступа к файлу не установлен бит исполнения группой (S_IXGRP), то бит S_ISGID означает принудительную блокировку на этом файле и не очищается функцией chown.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

В случае успеха возвращается ноль. При ошибке возвращается -1, а errno устанавливается должным образом.

ОШИБКИ¶

В зависимости от файловой системы могут также возвращаться другие ошибки. Общий набор ошибок chown перечислен ниже:

EPERM

Фактический UID не совпадает с владельцем файла и не равен нулю; параметры owner или group заданы неверно.

EROFS

Файл находится на файловой системе, смонтированной только для чтения.

EFAULT

path указывает за пределы доступного адресного пространства.

ENAMETOOLONG

path слишком длинно.

ENOENT

Файл не существует.

ENOMEM

Ядру не хватило памяти.

ENOTDIR

Компонент пути, использованный как каталог в path, в действительности таковым не является.

EACCES

Запрещен поиск в одном из каталогов, находящихся на пути к файлу.

ELOOP

При обработке path встречено слишком много символьных ссылок (возможно зацикливание по символьным ссылкам -- прим. пер.).

Общие ошибки fchown таковы:

EBADF

Неверный файловый дескриптор.

ENOENT

См. выше.

EPERM

См. выше.

EROFS

См. выше.

EIO

При модификации inode произошла низкоуровневая ошибка ввода-вывода.

ЗАМЕЧАНИЯ¶

В версиях Linux до 2.1.81 (кроме 2.1.46), chown не следовал по символьным ссылкам. Начиная с версии Linux 2.1.81 chown следует по символьным ссылкам, и существует новый системный вызов lchown, который не следует по символьным ссылкам. Начиная с Linux 2.1.86 этот новый вызов (имеющий ту же смысл, что и старый chown), имеет тот же самый номер системного вызова, а chown получил новый номер.

Прототип fchown доступен только если определен символ _BSD_SOURCE (или явно или неявно, но задан символ _POSIX_SOURCE или компиляция осуществляется с флагом -ansi).

СООТВЕТСТВИЕ СТАНДАРТАМ¶

Системный вызов chown соответствует SVr4, SVID, POSIX, X/OPEN. В версии 4.4BSD его может использовать только суперпользователь (то есть обычные пользователи не могут отдавать файлы). SVr4 документирует EINVAL, EINTR, ENOLINK и EMULTIHOP, но не документирует ENOMEM. POSIX.1 не документирует ENOMEM и ELOOP.

Системный вызов fchown соответствует 4.4BSD и SVr4. SVr4 документирует дополнительные коды ошибки EINVAL, EIO, EINTR и ENOLINK.

ОГРАНИЧЕНИЯ¶

Логика работы chown специально нарушается на файловых системах NFS с разрешенным преобразованием UID. Вдобавок логика работы нарушается у всех системных вызовов, которые обращаются к содержимому файла, потому что chown может привести к немедленному запрету доступа к уже открытым файлам. Кэширование на клиенте может привести к задержке между сменой владельца и истинным моментом, когда этот пользователь сможет обратиться к файлу с других клиентов.

СМОТРИ ТАКЖЕ¶

chmod(2), flock(2)

ПЕРЕВОД¶

Copyright (C) Alexey Mahotkin <alexm@hsys.msk.ru> 1999-2000, Виктор Вислобоков <corochoone@perm.ru> 2003